Inside Macintosh: QuickTime Components /

Chapter 9 - Movie Data Exchange Components / Movie Data Exchange Components Reference

Configuring Movie Data Import Components /

MovieImportSetAuxiliaryData

The MovieImportSetAuxiliaryData function allows an application to provide additional data to your component. Your component can then use this data during the data import process.

pascal ComponentResult MovieImportSetAuxiliaryData          
                                       (ComponentInstance ci,
                                        Handle data, 
                                        OSType handleType);

ci

Identifies the application's connection to your movie data import component.

data

Contains a handle to the additional data. Your component should not dispose of this handle. Be sure to copy any data you need to keep.

handleType

Identifies the type of data in the specified handle.

DESCRIPTION

The MovieImportSetAuxiliaryData function allows your component to accept additional data for use during the data import process. Your component may use this data in any way that is appropriate for a given import operation. For example, if your component imports data stored in 'TEXT' handles, you might choose to accept style information for that text. An application could provide that style information in a 'styl' handle supplied to your component by calling this function.

Your component should expect the application to call this function before the import process begins.

RESULT CODES

unsupportedAuxiliaryImportData	-2057	Cannot work with specified handle type
badComponentSelector	0x80008002	Function not supported

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help